home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr15 / wxview25.zip / WXVIEW.DOC < prev    next >
Text File  |  1993-05-03  |  42KB  |  908 lines

  1.                         W e a t h e r V i e w
  2.                              Version 2.5
  3.                    (c) Copyright 1993 Jim Haywood
  4.                                   
  5.  
  6. NOTICE TO REGISTERED USERS: 
  7.  
  8. BE SURE THAT THE FILE 'WXVIEW.KEY' FOUND ON YOUR REGISTRATION DISK IS
  9. LOCATED ON YOUR WORKING DIRECTORY.  OTHERWISE WXVIEW WILL ASSUME THIS
  10. IS A DEMONSTRATION VERSION AND HAVE NO GRAPHICS OTHER THAN THE DEMO
  11. DATA.  UPGRADE FROM VERSION 2.4 TO 2.5 INCLUDES:
  12.  
  13.      o    VARIABLE ZOOM WINDOW TO ENABLE EXTREME CLOSEUP
  14.  
  15.      o    <F1> KEY TO TOGGLE GRAPHIC COLORS ON/OFF FOR SCREEN DUMPS
  16.  
  17.      o    REPAIR A COUPLE OF MINOR BUGS IN THE DIGITAL RADAR FORMATTING
  18.           AND MAPPING SECTIONS
  19.  
  20.      o    SOME INTERNAL TWEAKING OF CODE TO REALLOCATE MEMORY AND ALLOW
  21.           UNLIMITED NUMBER OF MAP STATIONS TO BE USED
  22.  
  23.  
  24.  
  25. 1.0 WHAT IS WXVIEW?
  26.  
  27. WeatherView (WXVIEW) was written to provide anyone with a MS-DOS based
  28. personal computer and a modem the ability to view and analyze real-time
  29. National Weather Service (NWS) hourly data.  WXVIEW is offered as a
  30. shareware program therefore registration cost is held to a minimum. 
  31. This program rivals or beats expensive commercial programs and other
  32. shareware programs designed for weather surface depiction.  Without the
  33. coded 'key' file provided to registered users, the program will act as
  34. a demonstration version and allow any user to 'kick the tires' before
  35. expending any hard earned cash.  The demo version will work 100% with
  36. the supplied demo data set but have no graphics with user supplied NWS
  37. data.  
  38.  
  39. Minimum computer hardware required to operate WXVIEW:
  40.  
  41.           MS-DOS Environment
  42.           512K or more available memory
  43.           EGA video
  44.           80286 Processor Minimum (80386 or better recommended)
  45.           Math Coprocessor not necessary but highly recommended
  46.  
  47. Running WXVIEW is as easy as 1,2,3:
  48.  
  49.      1)   Download NWS data
  50.      2)   Reformat NWS data to column oriented format
  51.      3)   Graphically display weather or search station data by event
  52.  
  53. Specific capabilities of the WXVIEW program include:
  54.  
  55.      o    Format raw NWS surface airways (SA) data and digital radar
  56.           (SD) data to a column oriented format;
  57.  
  58.      o    Graphically display the following data in national or zoom
  59.           mode:
  60.  
  61.                -    Current observations
  62.                -    Cloud cover and base height
  63.                -    Visibility in statute miles
  64.                -    Pressure (with optional isobar plot)
  65.                -    Temperature
  66.                -    Dew point
  67.                -    Wind direction and speed flags
  68.                -    Digital radar map
  69.                -    Available NWS cities
  70.                -    Relative humidity
  71.                -    Wind chill
  72.                -    Apparent temperature (heat index)
  73.  
  74.      o    NWS data can be searched and displayed in common,
  75.           understandable text by the following criteria:
  76.  
  77.                -    Search by city name or NWS code
  78.                -    Search by state
  79.                -    Search for extremes in data set
  80.                -    Search by following precipitation types:
  81.  
  82.                          Rain
  83.                          Drizzle
  84.                          Snow                     
  85.                          Thunderstorm
  86.                          Ice
  87.                          Freezing precipitation
  88.                          Hail
  89.  
  90.                -    Search for temperatures greater than
  91.                -    Search for temperature less than
  92.  
  93.           User configuration allows user to search U.S. data only or
  94.           search both U.S. and Canadian data.
  95.  
  96.      o    Program can be user configured with the following options:
  97.  
  98.                -    Define parameter to overlay pressure isobar
  99.                -    Include or exclude Canadian data in searches
  100.                -    Specify isobar smoothing passes (minimum of 1,
  101.                     maximum of 3)
  102.                -    Toggle on/off 3-D shadowing
  103.                -    Define time zone 
  104.                -    Define text editor to correct faulty data (public
  105.                     domain editor provided with WXVIEW)
  106.  
  107.      o    Ability to archive and retrieve data sets 
  108.  
  109. Each of these options will be detailed in following sections along with
  110. typical benchmark time tests from various machines.
  111.  
  112. THE CATCH: The user has to provide his/her own NWS data.  In this
  113. modern age of data at your fingertips, this is not a problem unless you
  114. don't have a modem.  The three cheapest sources of NWS hourly data I've
  115. found and used are:
  116.  
  117.           -    Compuserve ($8.95 per month for basic service)
  118.           -    Weathermation (free locally if available)
  119.           -    GTE Contel DUAT (free 800 number)
  120.  
  121.  
  122. 2.0 THE HISTORY OF WXVIEW
  123.  
  124. As a Penn State graduate (Meteorology 1979) and professional
  125. meteorologist working in the field of industrial air pollution, I have
  126. missed working with forecasting and observation (the first love of all
  127. meteorologists).  As such, WXVIEW was born in 1986 as a BASIC program
  128. which reformatted NWS surface airways (SA) data and plotted the basic
  129. parameters on rough regional maps.  With the desire to expand
  130. capabilities and increase speed, the BASIC program was scrapped and re-
  131. written in a combination of Microsoft Quick C and Microsoft Assembler. 
  132. Originally intended for my own self-gratification as a meteorological
  133. hobby, I shared it with friends in the NWS and various state
  134. Departments of Natural Resources with whom I associate.  Through their
  135. encouragement and the fact that there are few comparable shareware
  136. programs, it is now released as a low cost program to others who also
  137. love having up-to-the-minute weather access.
  138.  
  139. 3.0 RETRIEVING THE NWS DATA SET
  140.  
  141. I am assuming that the user has a modem and is familiar with the fine
  142. art of telecommunications and text data capture.  If this is a false
  143. assumption, the user must learn telecommunications before this program
  144. will be of any use.
  145.  
  146. There are many sources of NWS and Canadian weather data.  As mentioned
  147. in Section 1.0, the three cheapest sources of data I know are:
  148.  
  149.      o    Compuserve - The basic service price of $8.95 per month
  150.           allows unlimited access to NWS hourly surface airways data
  151.           (SA) and digital radar data (SD).  From within Compuserve,
  152.           type GO AWX to get to the aviation weather menu.  This is the
  153.           service I use most frequently.
  154.  
  155.      o    Weatherbrief - This is a free dial-in service provided by
  156.           many state's Bureau of Aviation for pilots.  All SA and SD
  157.           data for U.S. and Canada are available.
  158.  
  159.      o    GTE Contel DUAT - This is provided by a toll free number (1-
  160.           800-767-9989).  Although all SA and SD data are available,
  161.           data must be retrieved on a state-by-state basis.  This pilot
  162.           service is also free but the most time consuming service.
  163. After getting into your NWS data source, turn on the text capture
  164. ability of your communications program.  By entering a SA or SD
  165. command, hourly data will be displayed and captured to a file on your
  166. local disk.  For example, SA MN,IA,WI will display surface data for
  167. Minnesota, Iowa, and Wisconsin while entering SD MN,IA,WI will display
  168. digital radar for Minnesota, Iowa, and Wisconsin.  Within the
  169. Compuserve database, entering SA US will display data for the entire
  170. U.S.  Entering SA @ALL will trigger all data for all North America. 
  171. Entering SD US will display all digital radar data readings from the
  172. U.S.  
  173.  
  174. I have macros set up within my telecommunications program to specify
  175. the 48 continental states, Canadian border provinces, and U.S. digital
  176. radar.  Use of macros makes data retrieval very easy and quick.
  177.  
  178. The NWS takes SA hourly readings at approximately 5 to 10 minutes
  179. before each hour.  The accumulation of all SA data gives a 'snapshot'
  180. of the weather at that moment in time.  Typically, the SA data is
  181. available for download at 10 to 15 minutes after the hour.  Canadian
  182. data usually is available around half past the hour.
  183.  
  184. The data retrieved in the SA format is interpreted from its raw format
  185. in the following manner.
  186.  
  187. Weather & Visibility Codes         Prefixes        Suffixes
  188. -------------------------         ---------       --------
  189. hAil           drizzLe            Blowing         shoWers
  190. Dust           saNd               freeZing        + heavy
  191. Fog            Rain                               - light
  192. Ground Fog     Snow                               ++ very heavy
  193. Haze           Snow Grains
  194. Ice Crystals   Snow Pellets
  195. Ice Fog        Thunderstorms
  196. Ice Pellets    spraY
  197. smoKe          freeZing Rain
  198.                shoWer
  199.  
  200. Cloud Abbreviations                             Ceiling Prefixes
  201. -------------------------------------           ----------------
  202. CLR       CLEAR: <10% sky cover                   E-Estimated
  203. SCT       SCATTERED: 10-50% sky cover             M-Measured
  204. BKN       BROKEN: 60-90% sky cover                W-Indefinite
  205. OVC       OVERCAST: >90% sky cover                V-Variable
  206. -         THIN (prefix)
  207. X         OBSCURATION: sky obscured
  208. -X        PARTIAL OBSCURATION: sky partially obscured
  209.  
  210.  
  211. SA data Example:
  212.  
  213. LGA SA 1352 15 SCT M25 OVC 1R-F 132/58/56/1815G21/993/R28LVR20
  214.  
  215. LGA      =     LaGuardia  SA=regular hourly Surface observAtion
  216.                [SP=special]
  217. 1352     =     time of observation 13:52 UCT [EDT+5; EST+4]
  218. 15 SCT   =     scattered clouds 1500' above ground(airport) elevation
  219. M25 OVC  =     overcast clouds measured at 2,500 AGL
  220. 1R-F     =     visibility 1 statute mile, with restriction to
  221.                visibility identified as light rain and fog
  222. 132      =     barometric pressure in millibars=1013.2
  223. 58/56    =     temperature / dew point in F
  224. 1815G21  =     wind from 180 degrees magnetic at 15 knots; peak gust 21
  225. R28LRV20 =     runway 28 left visual range 2000 feet
  226.  
  227.  
  228. The data retrieved in the raw SD format is decoded in the following
  229. manner.
  230.  
  231. Format:
  232. Station ID/time/location intensity azimuth and range/movement/
  233. tops/precipitation type-intensity trend/remarks/end
  234.  
  235. Example: NYC 1930 AREA 2 TRW++/+ 297/130 152/115 160W C2620
  236. MT 300 AT 254/39 HAIL REPORTED THIS CELL
  237.  
  238. NYC RADAR 1930 UCT; AREA OF ECHOES 2/10 COVERAGE, VERY HVY
  239. THUNDERSTORMS FROM 297 DEGREES/130 NM TO 152 DEGREES/115 NM; AREA IS
  240. 160NM WIDE;MAX TOP 30,000' AT 245 DEG/39NM; RMKS PLAIN LANGUAGE;
  241.  
  242. Intensity Decoder
  243.  
  244. Level          Echo Intensity      Precip Intsy    Rainfall Rate
  245. -----          --------------      -------------   -------------
  246.   1               Weak             None or light    <.1-.2
  247.   2             Moderate           Moderate          .1-1.1
  248.   3              Strong            Heavy             .5-2.2
  249.   4           Very Strong          Very Heavy       2.2-4.5*
  250.   5              Intense           Intense          4.5-7.1*
  251.   6              Extreme           Extreme          >7.1 in/hr
  252.   *= only in convective situations
  253.   8            Unknown but associated with severe wx
  254.   9            Unknown
  255.  
  256. Abbreviations
  257. -------------
  258. HOOK - signature "tail" usually associated with tornadoes
  259. HAIL - radar indicated hail
  260. LINE - echoes are in a line
  261. LEWP - Line Echo Wave Pattern - wavy line
  262. FNLN - FiNe LiNe; narrow non-precipitation echo pattern
  263. BWER - Bounded Weak Echo Region - echo free vault within a cell
  264. ALFT - precipitation ALoFT
  265. MALF - Mostly ALoFt precipitation
  266. PALF - Partly ALoFt precipitation
  267. MLVL - Melting LeVeL; radar detection of melting of frozen precip
  268. PCLL - Persistent CeLLs
  269. SLD  - SoLiD areas of 80% or more
  270.  
  271. PPINE - equipment normal; No Echoes
  272.    OM - inOp or out of service for Maintenance
  273.    NA - observation Not Available
  274.    NS - equipment normal; No Significant echoes
  275. ROBEPS  Radar Operating BElow Performance Standards
  276. ARNO  - Azimuth Range indicator iNOperative
  277. RHINO - Radar Height Indicator iNOperative      
  278.  
  279. Note: above SA and SD decoding information was taken from the
  280. Compuserve file WXDECO.TXT.
  281.  
  282. The NWS radar stations take the SD digital radar reading at
  283. approximately 25 minutes past the hour.  It is usually available for
  284. download at 45 minutes after the hour.
  285.  
  286. The provided file 'DEMO.DAT' is a demonstration file of a Compuserve
  287. data download session which captured the 48 continental states,
  288. Canadian border provinces, and U.S digital radar.  THE PROVIDED
  289. DEMONSTRATION DATA FILE 'DATA.DAT' IS ENCODED TO WORK 100% WITH WXVIEW. 
  290. DATA DOWNLOADED BY THE USER WILL HAVE NO GRAPHIC CAPABILITIES.
  291.  
  292. 4.0 RUNNING WEATHERVIEW
  293.  
  294. Simply enter the command "WXVIEW" to begin the program.  The following
  295. files must be present in the local directory for WXVIEW to run
  296. properly:
  297.  
  298.  
  299.      WXVIEW.EXE -   Executable program file
  300.      WXVIEW.FIG -   Configuration file (Demo version)
  301.      WXCITY.NAM -   Available station names and NWS codes
  302.      WXNATL.CRD -   Station coordinates for national map
  303.      WXNATL.BIN -   National map file (binary format)
  304.      WXZOOM.CRD -   Station coordinates for zoom map
  305.      WXZOOM.BIN -   Zoom map file (binary format)
  306.      WXRADAR.CRD -  Station coordinates for digital radar
  307.      WXVIEW.SA -    Current formatted SA surface data set
  308.      WXVIEW.SD -    Current formatted SD radar data set
  309.  
  310. Other files included but not critical to the program are:
  311.  
  312.      WXVIEW.PRS -   Current isobar grid array
  313.      WXVIEW.DOC -   Documentation file (what you are reading)
  314.      TED3.COM -     Public domain text editor.  May be substituted for
  315.                     user's choice editor in program configuration
  316.                     option.
  317.      DEMO.DAT -     Demonstration raw data which is encoded to be 100%
  318.                     operational for demonstration purposes. 
  319.                     WXVIEW.SA, WXVIEW.SD and WXVIEW.PRS bundled with
  320.                     the program were generated by formatting this demo
  321.                     data set.  User supplied data will have limited
  322.                     use in the graphic display section.
  323.      REGISTER.TXT - Registration information.
  324.      READ.ME -      Any upgrade information.
  325.  
  326. Provided to Registered Users only...
  327.  
  328.      WXVIEW.KEY -   Encoded key file which unlocks WXVIEW for 100%
  329.                     usage.  This file must be present in the working
  330.                     directory otherwise, WXVIEW assumes you are a demo
  331.                     user and will have no graphics other than the
  332.                     provided demo data.  This way, upgrades can be
  333.                     quickly and easily provided to registered users on
  334.                     Compuserve and other BBS's while other users will
  335.                     have a new demo to test.  This file must not be
  336.                     modify or corrupted in any way.
  337.  
  338. After entering the WXVIEW command, the WXVIEW program will present a
  339. title screen while loading configuration.  During configuration
  340. loading, the program loads all city names, coordinates, and user
  341. configuration data into memory.  Time to load varies with the type of
  342. computer used.  Typical loading times are as follows:
  343.  
  344. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  345.  
  346.      7 sec                         2 sec                  1 sec
  347.  
  348.  
  349. Use the cursor keys to highlight the desired choice and then press
  350. enter key.
  351.  
  352. 4.1 Reformatting NWS data set
  353.  
  354. THIS OPTION MUST BE PERFORMED BEFORE WXVIEW CAN GRAPHICALLY VIEW OR
  355. SEARCH ANY USER PROVIDED NWS DATA.
  356.  
  357. To analyze or display the NWS data in the fastest, most efficient
  358. method, the rough format of the SA and SD raw data is formatted to a
  359. column oriented format.  This format is easily readable by the WXVIEW
  360. program and any other database management program requiring column
  361. oriented text data.  The data is formatted into the following format:
  362.  
  363. Parameter                          Start column   Stop column
  364.  
  365. NWS city code                           1               3
  366. Greenwich mean time                     5               8
  367. Current weather                         10             17
  368. Visibility (Statute miles)              18             21
  369. Abbreviated pressure (millibars)        24             26
  370. Temperature (Degrees Fahrenheit)        28             30
  371. Dew Point (Degrees Fahrenheit)          32             34
  372. Wind direction/Wind speed (Deg/Knots)   37             40
  373. Abbreviated altimeter (inches)          42             44
  374. Cloud cover                             47             80
  375.  
  376.  
  377. This option reads ALL valid NWS/Canadian SA/SP/RS data, formats it and
  378. stores the results in a temporary file.  An on-screen counter informs
  379. the user of how many observations are being formatted.  During the
  380. formatting step, WXVIEW determines which hour has the most
  381. observations.  The temporary file is re-read and ONLY observations for
  382. that hour are written to the final file (WXVIEW.SA).  An on-screen
  383. counter keeps track of how many observations are written to the final
  384. file.  If several observations are reported for a single station during
  385. the same hour, WXVIEW accepts the first observation read in the raw NWS
  386. data file and ignores the rest.  
  387.  
  388. A vigorous error screening protocol is applied to the final WXVIEW.SA
  389. data set.  If WXVIEW suspects an error in a station observation for the
  390. valid hour, that observation is rejected and written to an alternate
  391. file named BAD.OUT.  The user may wish to review this file and apply
  392. corrections if desired.  The user is prompted to press a key after the
  393. SA data set is processed.  A similar process to format the SD digital
  394. radar set follows.  
  395.  
  396. The internal computer system date is used to date stamp the formatted
  397. WXVIEW.SA file.  The observation date and Greenwich mean time make up
  398. the first line of WXVIEW.SA and WXVIEW.SD.
  399.  
  400. Formatting a NWS data set need not be repeated until a NEW data set is
  401. downloaded.
  402.  
  403. Typical times to reformat SA and SD data from the 48 states and 9
  404. Canadian border provinces are:
  405.  
  406. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  407.  
  408.      1 min 34 sec                  20 sec                15 sec
  409.  
  410.  
  411. The user is recommended to download both the SA and SD data into the
  412. same file.  However, if the user wishes download just the SA or just
  413. the SD data, WXVIEW will preserve the last formatted session of the
  414. non-downloaded parameter.
  415.  
  416. Please note that temperature and dew point in the downloaded Canadian
  417. weather data are in degrees Celsius.  These data are converted into
  418. degrees Fahrenheit in all WXVIEW displays and text searches.  
  419. Also note that ALL NWS/Canadian wind speeds are in knots.  All wind
  420. speeds are converted to miles per hour (mph) for graphic wind staff
  421. displays and text searches.
  422.  
  423. 4.2 View the Graphic Data Set
  424.  
  425. For demo users, the WXVIEW program works 100% with the provided demo
  426. data set.  HOWEVER, FOR USER SUPPLIED DATA, NO GRAPHIC DISPLAY OPTIONS
  427. ARE AVAILABLE.
  428.  
  429. This is the only limitation between the demo version and the registered
  430. version.  Only registered users receive the 'WXVIEW.KEY' file which
  431. unlocks the fully functional program.  
  432.  
  433. When chosen, this option graphically displays the last formatted or
  434. retrieved data set.  WXVIEW will take a few seconds (depending on
  435. machine speed) to load applicable station data into memory.  Expected
  436. times to load the national data set are as follows:
  437.  
  438. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  439.  
  440.        20 sec                      4 sec                 2 sec
  441.  
  442. The national data array is loaded into memory only once per session
  443. unless the current data set is edited or a new data set is loaded.
  444.  
  445. If this is a NEW data set or an EDITED data set, WXVIEW will attempt to
  446. grid pressure data for isobar plotting.  The grid array contains 31 x
  447. 25 grid points.  Depending on the type of machine used and whether or
  448. not a math coprocessor is used, this can be a time consuming ordeal. 
  449. Expected times are as follows:
  450.  
  451. 8Mhz 286 w/coprocessor   25 Mhz 386 wo/coprocessor     25 Mhz 486
  452.  
  453.      1 min 57 sec             1 min 31 sec               10 sec
  454.  
  455.  
  456. The isobar plotting option can be aborted by pressing the escape (ESC)
  457. key.  Smoothing passes to 'iron out' the rough edges of the isobar
  458. plots are determined in the user configuration section.  Gridding needs
  459. to be done only once per data set unless the user edits the formatted
  460. data file.  If reviewing previously gridded data, isobar gridding will
  461. not be redone.  Note: if there is less than 100 stations in the SA data
  462. array, WXVIEW will NOT grid data or plot isobars due to insufficient
  463. data.
  464.  
  465. After the pressure gridding routine is completed, aborted, or skipped
  466. (if previously gridded), WXVIEW displays the national weather map with
  467. current observations and the first menu bar.  The two menu bars are
  468. toggled by the  (up) and  (down) cursor keys.  Any menu option can be
  469. chosen by moving the cursor and pressing enter or instantly chosen by
  470. pressing the displayed 'hot key' for that option.
  471.  
  472. Menu Bar 1 options:
  473.  
  474.      OBS -     Current weather in the same code as provided in the raw
  475.                NWS data set.
  476.  
  477.      SKY -     Cloud cover.  Clear circle indicates clear skies.  Blue
  478.                in upper right quadrant indicates scattered cloud cover. 
  479.                Orange covering 2/3 of circle indicates broken cloud
  480.                cover.  Dull white in all or part of circle indicates
  481.                overcast. Combinations of cloud covers can occur. 
  482.                Number appearing below circle for broken and/or overcast
  483.                skies is cloud base in hundreds of feet (i.e. 250
  484.                implies cloud base at 25,000 ft).  Circle with an 'X'
  485.                indicate obscured sky.
  486.  
  487.      VIS -     Visibility in statute miles.  Fractional distances are
  488.                interpreted in the following manner: 11/2 indicates 1
  489.                and 1/2 statute miles.
  490.  
  491.      PRESS -   Pressure in millibars.  If pressure gridding was
  492.                completed for a data set, isobars are drawn.  Isobars
  493.                are spaced four millibars apart (ranging from 950 to
  494.                1054) and are not labeled.  The default overlay is
  495.                numeric pressure in millibars but can be changed in the
  496.                configuration option.  Highs and lows are calculated
  497.                from the pressure grid and displayed.  Positioning of
  498.                the highs and lows are approximate due to grid spacing. 
  499.                The best way to identify the EXACT position of a low
  500.                pressure system is to check the wind field.  If the
  501.                isobar gridding option was aborted, only numeric
  502.                pressure in millibars is displayed.
  503.  
  504.                When displaying the isobar plot on the national map,
  505.                isobars are 'flashed' off the Atlantic, Pacific, and
  506.                Mexican areas.  No stations are plotted for these areas
  507.                so isobar gridding is erratic and unrepresentative.
  508.  
  509.      TEMP -    Temperature in degrees Fahrenheit.  Color of temperature
  510.                display changes every 10 degrees to provide quick color
  511.                overview of the temperature pattern.
  512.  
  513.      DEW -     Dew point in degrees Fahrenheit.  Color of dew point
  514.                display changes every 10 degrees to provide quick color
  515.                overview of the dew point pattern.
  516.  
  517.      WIND -    Wind direction and wind speed are graphically displayed
  518.                as wind flags similar to those found on NWS maps.  The
  519.                flags can be thought of as arrows pointing in the
  520.                direction the wind is blowing toward.  Each full barb on
  521.                the wind flag represents 10 mph of wind speed (there is
  522.                a conversion in the wind data from knots to mph, 1 knot
  523.                equals 1.15 mph).  With limited pressure grid spacing,
  524.                the wind field is the best way to locate the center of
  525.                a low pressure system.  A strong low, in a field of wind
  526.                flags, can resemble water going down the drain.  At the
  527.                center of the swirl is the low.
  528.  
  529.                If zero winds (calm) are reported for a station, a small
  530.                zero is placed at the station location.
  531.  
  532.      RADAR -   Digital radar.  Color indicates precipitation intensity
  533.                as shown on top of screen bar.  User will need to press
  534.                any key after viewing to return to menu bar.  Digital
  535.                radar data can overlap if reporting radar stations are
  536.                in close proximity to each other.  
  537.  
  538.                Since SD radar readings occur approximately 30 minutes
  539.                after the SA surface observation, radar and current
  540.                weather may not always agree.
  541.      CITY -    Display all available NWS and Canadian stations
  542.                available for graphic display.
  543.  
  544.      EXIT -    Return to previous menu.
  545.  
  546.  
  547. Menu Bar 2 options:
  548.  
  549.      ZOOM -    Available from national map only.  Zoom box appears in
  550.                center of U.S. map.  Move box in straight line or
  551.                diagonally with cursor keys to desired zooming location. 
  552.                Press enter key.  WXVIEW will take a few seconds (about
  553.                the same time it takes to load the national map) to load
  554.                data from the zoom area stations into memory.  All
  555.                available NWS and Canadian stations are displayed in the
  556.                zoom mode to provide better resolution of the mesoscale
  557.                weather picture.
  558.  
  559.                The first zoom box shown is the maximum size of the zoom
  560.                window.  By pressing the minus key (-) or the plus key
  561.                (+), the zoom window size can be adjusted.
  562.  
  563.      GROUP -   Available from the zoom map only.  This option is for
  564.                those who want it all on one screen.  All reported
  565.                parameters in the SA data set are reported on one
  566.                screen.  The format of the layout for each station is as
  567.                follows:
  568.  
  569.                          (temp)       (pressure (abbreviated))
  570.               (current weather) (sky) (visibility (miles))
  571.                        (dew pt)       (cloud base (hundreds of ft))
  572.  
  573.  
  574.      RELATIVE
  575.      HUMIDITY- Relative Humidity in percent.  Color of percentage
  576.                changes every 10 degrees to provide quick color overview
  577.                of the relative humidity pattern.
  578.  
  579.      WIND
  580.      CHILL -   Wind chill temperature in degrees Fahrenheit.  Color of
  581.                wind chill temperature changes every 10 degrees to
  582.                provide quick color overview the wind chill temperature
  583.                pattern.  Wind chill is NOT calculated if wind speed is
  584.                3 mph or less.  Wind chill is also NOT calculated when
  585.                ambient temperature is 60 degrees or greater.  
  586.  
  587.                Algorithms to calculate the relative humidity and wind
  588.                chill were gratefully received from Mr. Dan Noah of the
  589.                Madison, WI National Weather Service.
  590.  
  591.      APPARENT
  592.      TEMP. -   Apparent temperature in degrees Fahrenheit.  The NWS has
  593.                adopted the apparent temperature index (heat index) as
  594.                a summertime measure of sultriness.  Color of apparent
  595.                temperature changes every 10 degrees to provide quick
  596.                color overview the apparent temperature pattern. 
  597.                Apparent temperatures are NOT calculated when ambient
  598.                temperature is less than 60 degrees.  
  599.  
  600.                The algorithm for the apparent temperature calculation
  601.                was obtained from the August 1985 Weatherwise magazine.
  602.  
  603. Pressing the escape (ESC) key or pressing the 'E' key will return the
  604. user to the previous menu.
  605.  
  606. GRAPHIC SCREEN DUMPS TO PRINTER AFTER USING <F1> KEY COLOR TOGGLE:
  607. Since many screen dump utilities are readily available, WXVIEW does not
  608. provide a print routine.  Programs of this type can probably be found
  609. on your local BBS.  These programs work best when graphics are shown in
  610. black and white.  The user can toggle graphic colors on/off with the
  611. <F1> key to serve this purpose.  For version 2.5, set screen type to
  612. EGA.  Check your local BBS for screen dump utility programs.
  613.  
  614. 4.3 WEATHER EVENT SEARCH
  615.  
  616. This section of the WXVIEW program allows the user to search the
  617. weather data by several criteria and receive an expanded version of
  618. station data in easy to read text.  Matches to the search criteria are
  619. displayed in half screen segments while prompting the user to press a
  620. key to continue.  When the next search match is found, the top screen
  621. information is scrolled down to the bottom half screen. 
  622.  
  623. The user can only search forward through the data (i.e. you can not
  624. back up and review data which have already scrolled of the screen).  
  625.  
  626. The user can break away at any time between search matches by pressing
  627. the escape (ESC) key or the 'E' key.
  628.  
  629. The various search criteria are detailed in the following subsections.
  630.  
  631.      4.3.1 Search by City of NWS Code
  632.  
  633.      The user is prompted for an entry.  For example, if the user
  634.      wishes to review the weather for Nashville, TN (NWS code is BNA),
  635.      the user can type either BNA or an abbreviated part of the name
  636.      'Nashville' (i.e. Nash).  If the user is typing an abbreviated
  637.      portion of the city name, it must be the beginning portion of the
  638.      name.  WXVIEW does not perform imbedded text searches.  
  639.  
  640.      User entry can be in either upper or lower case.
  641.  
  642.      All matches fitting the entry will be displayed until no more
  643.      matches are found or the user aborts the search.  If no match is
  644.      found in the city/code database, the user is notified.  If an
  645.      entry match is found in the city/code database but no data is
  646.      found in the current weather file, the user is also notified.  
  647.  
  648.      This option includes data search for Alaska and Hawaii stations. 
  649.      If the user has chosen to allow Canadian data to also be searched
  650.      (in the configuration section), Canadian city/code matches will
  651.      also be displayed.  
  652.  
  653.      4.3.2 Search by State
  654.  
  655.      The user is prompted for a 2 letter state abbreviation.  Entering
  656.      TN will display all matches for the state of Tennessee.  If the
  657.      user has chosen to allow Canadian data to also be searched,
  658.      entering a 2 letter Canadian province will allow the provinces
  659.      data to be displayed (i.e. MB for Manitoba).
  660.  
  661.      User entry can be in either upper or lower case.
  662.  
  663.      4.3.3 Search by Extremes
  664.  
  665.      This option will search the entire database (including or
  666.      excluding Canadian data depending on user configuration) for
  667.      weather extremes and list them on a single screen display. 
  668.      Parameters searched and displayed are: highest temperature, lowest
  669.      temperature, highest wind speed, highest pressure, and lowest
  670.      pressure.  Also displayed are any stations listing heavy
  671.      precipitation.
  672.  
  673.      If more than one station reports the same extreme or heavy
  674.      precipitation, the additional stations are also listed (up to six
  675.      stations).
  676.  
  677.      4.3.4 Search by Precipitation
  678.  
  679.      The user can search the data for stations reporting specific
  680.      precipitation.  The precipitation choices available for search
  681.      are: Rain, Snow, Drizzle, Thunderstorm, Ice, Freezing
  682.      precipitation, and Hail.  If no stations report the searched
  683.      event, the user is returned to the precipitation menu. 
  684.  
  685.      4.3.5 Search for Temperatures Greater Than
  686.  
  687.      WXVIEW will search and display all stations reporting a
  688.      temperature greater than or equal to the value entered by the
  689.      user.
  690.  
  691.      4.3.6 Search for Temperatures Less Than
  692.  
  693.      WXVIEW will search and display all stations reporting a
  694.      temperature less than the value entered by the user.
  695.  
  696.  
  697. 4.4 SAVE/REVIEW WEATHER DATA
  698.  
  699. Occasionally, a viewed map is special because of some significant
  700. weather event.  The user has the option to save the current map and
  701. retrieve it for later viewing.  The user is prompted to enter 'S' to
  702. save the current file, or 'R' to retrieve an archived file.  If 'S' is
  703. chosen, the user is prompted to enter a filename (without any
  704. extension).  The files saved to disk will be:
  705.  
  706.           filename.SA  - Saved SA data
  707.           filename.SD  - Saved SD digital radar
  708.           filename.PRS - Saved isobar grid (if grid was created)
  709.  
  710. Do not use the name WXVIEW to archive because these are reserved
  711. filenames.
  712.  
  713. If retrieving an archived file using the 'R' option, the user is
  714. prompted to enter a filename (without any extension).  If the files do
  715. not exist, the user is notified.  
  716.  
  717. WXVIEW does not provide any means to delete archived files or do a
  718. directory search.  The user can easily delete unwanted archive files
  719. from the DOS prompt by entering 'DEL filename.*' (using the correct
  720. filename, of course).
  721.  
  722. 4.5 EDIT CURRENT DATA SET
  723.  
  724. Occasionally bad data gets through the screening routine during the
  725. formatting of raw NWS data.  One of the most frequent I've seen is
  726. faulty pressure data which can result in bizarre isobar plotting.  If
  727. the faulty station can be identified, the user can use this editing
  728. option to correct or delete the faulty data.
  729.  
  730. A public domain text editor has been included with WXVIEW to serve this
  731. purpose.  This editor (TED3 for tiny editor version 3.0) is limited to
  732. files less than 64K in size.  To work, the formatted SA data file,
  733. WXVIEW.SA, must be less than 64K.  If you have downloaded just the 48
  734. states and border provinces of Canada, the formatted WXVIEW.SA should
  735. be less than 64K.  If you have downloaded the entire North American
  736. database (i.e. entered SA @ALL in Compuserve), the formatted file may
  737. be larger than 64K.  
  738.  
  739. After exiting the text editor, the user is prompted whether or not to
  740. re-grid the pressure data when attempting to graphically display data. 
  741. If pressure data has not been changed, there is no need to repeat the
  742. gridding process.  WXVIEW will assume some data has been changed and
  743. will re-load the national data array before displaying any maps.
  744.  
  745. The user can opt to substitute his/her own favorite text editor in the
  746. user configuration section.
  747.  
  748. If there is not enough remaining memory to load the text editor or the
  749. WXVIEW.SA is larger than 64K (using the TED3 editor), editing is
  750. aborted and the user is immediately returned to the menu.
  751.  
  752. CAUTION: Do not edit the demonstration file 'DEMO.DAT'.  This file has
  753. been encoded to allow for 100% use in the demonstration version of
  754. WXVIEW.  Editing may disrupt the encoding.
  755.  
  756. 4.6 CONFIGURE PROGRAM
  757. WXVIEW has several user configurable options as detailed in the
  758. following subsections.
  759.  
  760.      4.6.1 Change U.S. Isobar Overlay Option
  761.  
  762.      The default isobar overlay parameter at the beginning of each
  763.      WXVIEW session is the numeric pressure in millibars.  At times it
  764.      is interesting to overlay a different parameter on the isobar
  765.      field.  Available overlay parameters are: Wind direction/speed
  766.      flags, cloud cover, temperature, current weather, and digital
  767.      radar.
  768.  
  769.      4.6.2 Weather Event Search on US/Canadian Data
  770.  
  771.      The user can choose to include or exclude Canadian data in the
  772.      weather search option.  For example, Canadian data almost always
  773.      generates the low temperature reading during the extremes search. 
  774.      If you don't want to see this, you can switch off Canadian data
  775.      search by toggling this menu option.  Pressing enter when this
  776.      option is highlighted will toggle the choices.
  777.  
  778.      4.6.3 Isobar Grid Screening Passes
  779.  
  780.      The pressure isobar gridding usually produces a rough isobar plot. 
  781.      By sending the pressure grid through a 'smoothing' routine, the
  782.      contours can be somewhat smoothed for a more realistic appearing
  783.      isobar plot.  The user can specify a minimum of one (1) to a
  784.      maximum of three (3) smoothing passes.
  785.  
  786.      If this option is chosen, then WXVIEW will attempt to re-grid the
  787.      pressure data when the graphic display option is again chosen.
  788.  
  789.      4.6.4 Toggle 3-D Shadow
  790.  
  791.      The user has the option to view graphically displayed data in a
  792.      simulated 3-D effect.  The 3-D effect appears to have the data
  793.      raised off the screen leaving a shadow.  If this effect is not
  794.      desired, it can be toggled on/off with this option.  Pressing
  795.      enter when this option is highlighted will toggle the choices.
  796.  
  797.      4.6.5 Change Time Zone
  798.  
  799.      The graphic maps and search display screen list the local time of
  800.      observation.  The user can change the displayed time zone to match
  801.      the local time zone.  Preprogrammed zones are EST, EDT, CST, CDT,
  802.      MST, MDT, PST, and PDT.  Any other option will result in a prompt
  803.      to enter the number of hours to offset from Greenwich mean time.
  804.  
  805.      4.6.6 Select Text Editor
  806.  
  807.      A public domain text editor has been included with WXVIEW to serve
  808.      this purpose.  This editor (TED3 for tiny editor version 3.0) is
  809.      limited to files less than 64K in size.  To work, the formatted SA
  810.      data file, WXVIEW.SA, must be less than 64K.  If you have
  811.      downloaded just the 48 states and border provinces of Canada, the
  812.      formatted WXVIEW.SA should be less than 64K.  If you have
  813.      downloaded the entire North American database (i.e. entered SA
  814.      @ALL in Compuserve), the formatted file may be larger than 64K.  
  815.  
  816.      The user can, through this configuration option, choose a
  817.      different text editor other than the TED3 public domain editor
  818.      included with this software.  The user must choose a text editor
  819.      such as QEDIT and not a word processor such as WordPerfect.
  820.  
  821. 4.7 EXIT
  822.  
  823. Every program should have a challenge, therefore, I'll leave this one
  824. for everyone to figure out on their own.
  825.  
  826. 5.0 DISCLAIMER
  827.  
  828. As dictated by current social protocol, I am not responsible for any of
  829. my actions.  Therefore, you (the user) assume all responsibility for
  830. using this program.  In other words, if you fly your airplane into the
  831. side of a mountain, please don't blame me.  What you see is what you
  832. get with this program.  My personal intent with this program is to have
  833. fun and satisfy my need to keep up with the current weather.  Your end
  834. use of this program is your business.
  835.  
  836. 6.0 OBTAINING A REGISTERED COPY
  837.  
  838. If you a user testing this as a demo, you are encouraged to share this
  839. demonstration version with your friends.  So as not to violate the
  840. first law of thermodynamics (there is no such thing as a free lunch),
  841. there is a one time registration cost associated with this program. 
  842. All users MUST register if you plan to use this demonstration program
  843. beyond 30 days.  With registration comes the fully functional version
  844. of WXVIEW (remember, the demo version has limited graphic use with user
  845. supplied data). 
  846.  
  847. In the true sense of shareware ideology, I will keep the registration
  848. cost at a minimum to encourage wide use of this program.  To achieve
  849. this objective, documentation is provided ON DISK rather than a printed
  850. copy.  I will assume that if you have a modem, you probably splurged
  851. and bought a printer or, at least, have access to one.
  852.  
  853. After reviewing the demo version, I am sure you will agree that this is
  854. a bargain.  I have not found any other similar software (even with less
  855. capabilities) for less.  If you agree and wish to receive a registered
  856. copy, please remit the following:
  857.  
  858.  Cost     $25.00    Fully functional version 2.4 of WXVIEW
  859.            $4.95    Shipping and handling
  860.           ------
  861.           $29.95    Total
  862.  
  863.  
  864. Please send check or money order (no cash, credit card numbers, or
  865. trading stamps) to:
  866.  
  867.      Jim Haywood
  868.      2157 Forest Hill SE
  869.      Grand Rapids, MI  49546
  870.  
  871. I will send your disk out via the U.S. mail within two days of
  872. receiving your order.  Unless specified to the contrary, all orders
  873. will be provided on a 5.25" diskette.  I will follow up with a
  874. Compuserve notice (if available) to inform you that your disk has been
  875. mailed.
  876.  
  877. Since you will have a chance to completely review WXVIEW capability
  878. with the demo data, you know what you are getting and there will be NO
  879. refunds.
  880.  
  881. If you are a registered user of WeatherView software, THE REGISTERED
  882. VERSION OF WXVIEW FILES ARE NOT TO BE SHARED OR DISTRIBUTED.  I will
  883. trust your conscience and honesty not to share or distribute your
  884. registered copy.  
  885.  
  886. Both registered and demo user should feel free to contact me with any
  887. suggestions or comments through CompuServe, 72247,2072, or the above
  888. address.  
  889.  
  890. 7.0 FUTURE PLANS FOLLOWING VERSION 2.5
  891.  
  892. A utility program will be released within late spring which will allow
  893. the user to add/subtract map stations.  At some point, a program will
  894. be written for upper air analysis with data provided by the FDLO and
  895. FDHI options.  Future upgrades to WXVIEW as suggested by users at this
  896. time will include at a minimum:
  897.  
  898.      o    User configurable colors for graphic maps.
  899.  
  900.      o    Additional digital radar (SD) information (max heights, hook,
  901.           hail, etc)
  902.  
  903.      o    Increase video resolution option to VGA and SVGA
  904.  
  905.      o    Multiple hour looping of digital radar on national map
  906.           (hopefully incorporated with cell movement and speed
  907.           capabilities)
  908.